home *** CD-ROM | disk | FTP | other *** search
/ Aminet 16 / Aminet 16 (1996)(GTI - Schatztruhe)[!][Dec 1996].iso / Aminet / misc / emu / QDOS1.lha / QLboot / DOCs / QLfilesystem.doc < prev    next >
Text File  |  1996-10-15  |  6KB  |  151 lines
  1. --------------------------------------------------------------------------
  2.             Q L F I L E S Y T E M     v2.05.09
  3. --------------------------------------------------------------------------
  4.  
  5. The QL filesystem is a handler that allows transparent access to QDOS (QL)
  6. disks. The file system requires a device driver that can read and write PC
  7. style sectors, such as mfm.device or messydisk.device.
  8.  
  9. QL disks are accessed as QL0: in the internal drive, or QL1:, QL2:, QL3:
  10. etc... in the external drives.
  11.  
  12. The QL filesystem makes it possible to insert a QL disk into an Amiga
  13. drive and use it like any other disk. Files can be renamed, deleted or
  14. copied to and from QL disks, file dates can be set, disks can be relabled
  15. and so on...
  16.  
  17. --------------------------------------------------------------------------
  18.  
  19. ›1m›4mMOUNTING THE QL FILESYSTEM›0m
  20.  
  21. Under WB1.3 mountlst.ql should be placed in devs: and messydisk.device
  22. should be available. Type 'MOUNT QL0: from devs:mountlst.ql' in a Shell or
  23. add the command to your start-up device and REBOOT.
  24.  
  25. A typical mountlist entry would be as follows:
  26.  
  27. ›3mQL0:
  28.  FileSystem = l:QLFileSystem
  29.  Device     = mfm.device ; Unit = 0 ; Flags = 0
  30.  LowCyl     = 0  ; HighCyl = 79
  31.  Surfaces   = 2  ; BlocksPerTrack = 9
  32.  Reserved   = 0  ; Interleave = 0
  33.  Buffers    = 20 ; BufMemType = 1
  34.  Globvec    = -1
  35.  DosType    = 0x514C3541
  36.  Stacksize  = 8000
  37.  Priority   = 5
  38.  Mount        = 1›0m
  39.  
  40. Under WB2 with crossDOS, make sure that you have at least MOUNT 40.4 and
  41. SETPATCH 40.16 installed (distributed with AmiCDFS). Then install as in
  42. WB3 below. If you do not have crossDOS, install as in WB1.3.
  43.  
  44. Under WB3 copy the provided QL0 and QL1 definition files to
  45. devs:dosdrivers. Check that your start-up sequence contains the command
  46. 'MOUNT Devs/dosdrivers/~(#?.info)', then REBOOT.
  47.  
  48. --------------------------------------------------------------------------
  49.  
  50. ›4m›1mPROTECTION BITS AND FILE COMMENTS›0m
  51.  
  52. QL executable tasks are shown with the protection flags set to 'rwed', all
  53. other files are shown 'rw-d'.
  54.  
  55. Files on QDOS disks have a 64 byte header that is not normally seen. The
  56. header stores information such as creation date and task dataspace
  57. (similar to stacksize). The creation date is returned to AmigaDOS as the
  58. files datestamp, the tasks dataspace is presented to AmigaDOS in the file
  59. comment... as a series of hex bytes.
  60.  
  61. The format of the comment is as follows:
  62.  
  63.   ›3m'QLTASK:<byte length><byte offset><data><data...>'›0m
  64.  
  65. A typical comment would be:
  66.  
  67.   ›3m'QLTASK:040600002800'›0m
  68.  
  69. Which states that the four bytes at an offset six bytes from the start of
  70. the header, contain the information '00002800'. This indicates that the
  71. dataspace for this particular task is set to 10K.
  72.  
  73. --------------------------------------------------------------------------
  74.  
  75. ›4m›1mCOPYING AND ARCHIVING QL TASKS›0m
  76.  
  77. It is necessary to use the CLONE option whenever you are copying QL tasks.
  78. If you do not, the comment field, and hence the task dataspace size will
  79. be lost.
  80.  
  81. i.e. to copy all files with the extension '_task', from a QL disk in the
  82. internal drive onto the RAM disk type:
  83.  
  84.   ›3mCopy QL0:#?_task RAM: CLONE›0m
  85.  
  86. It makes sense to ALWAYS use the CLONE option when copying files on the
  87. Amiga, since it is usually desirable to preserve comments and always
  88. desirable to preserve file dates. Take note!
  89.  
  90. Similarly if you are archiving a QL task, remember to save comments.
  91.  
  92. --------------------------------------------------------------------------
  93.  
  94. ›4m›1mFORMATTING A QDOS DISK›0m
  95.  
  96. In WB2 and above, simply insert a disk, and from the workbench click on
  97. the QL0:??? disk icon and choose 'Format Disk...' from 'icons' menu. In
  98. WB1.3 and before, you are required to use the 'QLformat' command from the
  99. CLI as described below.
  100.  
  101. ›1mQLformat›0m
  102.  
  103. usage: ›3mQLformat -u<unit#> [options]›0m
  104.  
  105. options:
  106.  
  107.    ›3m[-d<devicename>]›0m eg ›3m-dmessydisk.device›0m (don't use)
  108.    ›3m[-m<medianame>]›0m  eg ›3m-mQLEmpty›0m (that's the default name)
  109.    ›3m[-a(miga)]›0m formats to read faster on the amiga (use)
  110.    ›3m[-q(uick)]›0m means don't format, just rewrite header/map (wipe)
  111.  
  112. eg: ›3mQLformat -u0 -mTestdisk -a›0m
  113.  
  114.    Means format the disk in unit 0 (ie internal drive), set the media
  115.    (volume) name to 'Testdisk' and set the sector interleave table to the
  116.    optimal for the amiga.
  117.  
  118. --------------------------------------------------------------------------
  119.  
  120. ›4m›1mHD DISKS AND QL DIRECTORIES›0m
  121.  
  122. This version of the QL file system supports high density QDOS disks.
  123. However as yet (v3.23), the Amiga-QDOS emulator does not. So although it
  124. is possible to swap HD disks between Amiga DOS and a suitably equipped QL,
  125. it will not be possible to utilise HD disks within the Amiga-QDOS
  126. emulator.
  127.  
  128. The QL file system also supports QL directories. However, disks that
  129. contain directories currently (v3.23) show a flat directory structure
  130. within the Amiga-QDOS emulator.
  131.  
  132. --------------------------------------------------------------------------
  133.  
  134. ›4m›1mKNOWN BUGS›0m
  135.  
  136. Sector writes are sometimes written out-of-order?, possibly. A symptom is
  137. that OCCASSIONALY the last file written to QL0: is not updated properly
  138. onto disk. Happens very rarely. Perhaps when the file written uses up the
  139. last sector on the disk. The exact circumstances are unclear.
  140.  
  141. --------------------------------------------------------------------------
  142.  
  143. ›4m›1mWARNING›0m
  144.  
  145. Please use this software carefully. No responsibility can be accepted for
  146. any loss of data.
  147.  
  148. ›1mFRANCIS N SWIFT›0m
  149.  
  150. --------------------------------------------------------------------------
  151.